๐๏ธGitะฏัะฐ๐๏ธ
docs/zh-rCN/user/telemetry-and-sensors.md fix/qr-error-correction (7b45f84f) Text, 6.52 KB
title: Telemetry & Sensors
parent: User Guide
nav_order: 9
last_updated: 2026-05-13
description: Sensor data on the mesh โ supported environment, air quality, and power sensors, plus configuration and viewing guides.
aliases:
โข sensors
โข ็ฏๅข
โข weather
โข power-metrics
Telemetry & Sensors
Meshtastic nodes can collect and share sensor data across the mesh network.
ๆป่ง
Telemetry allows nodes equipped with sensors to broadcast environmental, power, and device health information. This data is visible on the node detail screen and can be logged over time.
Device Telemetry
All Meshtastic nodes report basic device telemetry:
โโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโ
โ ๅ
ฌๅถ โ ่ฏดๆ โ Typical Range โ
โโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโค
โ ็ตๆฑ ็ต้ โ Charge percentage โ 0โ100% โ
โ ็ตๅ โ Battery voltage โ 3.0โ4.2V (LiPo) โ
โ ้ข้ๅฉ็จ็ โ % of airtime used locally โ 0โ100% โ
โ Air Utilization TX โ % of airtime used by this node โ 0โ100% โ
โ ๆญฃๅธธ่ฟ่กๆถ้ด โ Seconds since last boot โ Varies โ
โโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโ
Environment Sensors
Supported environmental sensors:
Temperature & Humidity
โโโโโโโโโโโฌโโโโโโโฌโโโโโโโฌโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ไผ ๆๅจ โ ๆธฉๅบฆ โ ๆนฟๅบฆ โ ๆฐๅ โ ๆณจ โ
โโโโโโโโโโโผโโโโโโโผโโโโโโโผโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ BME280 โ โ โ โ โ โ โ Recommended all-in-one โ
โ BME680 โ โ โ โ โ โ โ Adds gas resistance/IAQ โ
โ SHT31 โ โ โ โ โ โ โ High accuracy โ
โ MCP9808 โ โ โ โ โ โ โ Precision temperature โ
โ LPS22 โ โ โ โ โ โ โ Pressure only โ
โโโโโโโโโโโดโโโโโโโดโโโโโโโดโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโ
Air Quality
โโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ไผ ๆๅจ โ ๅ
ฌๅถ โ ๆณจ โ
โโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ BME680 โ Gas Resistance / IAQ โ Volatile organic compounds โ
โ PMSA003I โ PM1.0, PM2.5, PM10 โ Particulate matter โ
โ SEN55 โ PM, NOx, VOC, Temp, Humidity โ Multi-sensor โ
โโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Light & UV
โโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโ
โ ไผ ๆๅจ โ ๅ
ฌๅถ โ
โโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโค
โ OPT3001 โ Ambient light (lux) โ
โ VEML7700 โ Ambient light (lux) โ
โ LTR390 โ UV index โ
โโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโ
็ตๆบ่ฎก้
Nodes with INA-series power sensors can report:
โโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๅ
ฌๅถ โ ่ฏดๆ โ
โโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโค
โ Bus Voltage โ Supply rail voltage โ
โ ็ตๆต โ Power consumption (mA) โ
โ ็ตๆบ โ Calculated power (mW) โ
โโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโ
Useful for monitoring solar charging or battery health on remote nodes.
Configuring Telemetry
1. Navigate to Settings โ Module Config โ Telemetry.
2. Set reporting intervals:
โข Device Metrics Interval โ how often to broadcast device metrics
โข Environment Metrics Interval โ how often to broadcast sensor data
3. Enable specific sensor types as needed.
Recommended Intervals
โโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโ
โ Use Case โ Device (s) โ Environment (s) โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโค
โ Urban mesh (many nodes) โ 3600 โ 3600 โ
โ Rural mesh (few nodes) โ 900 โ 900 โ
โ Weather station โ 900 โ 300 โ
โ Battery conservation โ 7200 โ 7200 โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโ
โ โ ๏ธ Note: Shorter intervals increase airtime usage and battery drain across the mesh.
Air Quality Metrics
Nodes with particulate matter or COโ sensors report air quality data:
โโโโโโโโโฌโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๅ
ฌๅถ โ Unit โ ่ฏดๆ โ
โโโโโโโโโผโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ PM1.0 โ ยตg/mยณ โ Ultrafine particulate matter โ
โ PM2.5 โ ยตg/mยณ โ Fine particulate matter โ
โ PM10 โ ยตg/mยณ โ Coarse particulate matter โ
โ COโ โ ppm โ Carbon dioxide concentration โ
โโโโโโโโโดโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
COโ sensors such as the SCD4x also report their own temperature and humidity, which appear alongside the readings above. From PM2.5 history the app additionally derives an EPA NowCast AQI value.
The COโ reading is color-coded by severity (Good โ Stuffy โ Poor โ Unsafe โ Evacuate). See Node Metrics โ Air Quality for the exact ppm bands, colors, and AQI detail.
Air quality data can be viewed as info cards on the node detail screen, charted over time, and exported to CSV.
Viewing Telemetry
1. Navigate to Nodes and select a node.
2. Telemetry sections show on the detail screen:
โข Device Metrics (always available)
โข Environment Metrics (if sensors present)
โข Power Metrics (if INA sensor present)
โข Air Quality Metrics (if PM/COโ sensor present)
3. Historical graphs show trends over time.
้ฎ้ขๆๆฅ
โข No environment data showing? The remote node needs a physical sensor connected (e.g., BME280 on I2C). Device telemetry (battery, uptime) is always available, but environment metrics require hardware.
โข Stale readings? Check the reporting interval โ very long intervals (7200s+) mean data updates infrequently. Also verify the remote node is still online.
โข Sensor conflict on I2C bus? Some sensors share I2C addresses. If you have multiple sensors on the same bus, check for address collisions in the radio's serial debug output.
Related Topics
โข Node Metrics โ view telemetry data on the node detail screen
โข Settings โ Modules & Admin โ telemetry module configuration
โข Units & Locale โ temperature and pressure display units
Served by rngit 1.5.2 - Generated in 0.08s